<?php

declare (strict_types=1);

namespace app\admin\controller;

use think\response\Json;
use app\admin\service\admin\User as AdminUserService;
use app\admin\model\admin\User as UserModel;

/**
 * 超管后台认证控制器
 * 负责管理员登录认证相关的操作，包括：
 * 1. 管理员账号登录
 * 2. 管理员退出登录
 * @package app\admin\controller
 */
class Passport extends Controller
{
    /**
     * 强制验证当前访问的控制器方法method
     * 格式：['方法名' => '允许的请求类型']
     * @var array
     */
    protected array $methodRules = [
        'login' => 'POST', // 登录接口仅允许POST请求
    ];

    /**
     * 超管后台登录
     * 处理管理员登录请求，验证账号密码有效性
     * @return Json
     * @throws \think\db\exception\DataNotFoundException
     * @throws \think\db\exception\ModelNotFoundException
     * @throws \Exception
     */
    public function login(): Json
    {
        // 实例化管理员模型
        $model = new UserModel;
        
        // 执行登录验证（通过POST获取表单数据）
        // $this->postData() 获取请求参数，继承自基类Controller
        if (($userInfo = $model->login($this->postData())) === false) {
            // 登录失败返回错误信息（优先使用模型验证错误）
            return $this->renderError($model->getError() ?: '登录失败');
        }
        
        // 登录成功返回用户ID和认证令牌
        return $this->renderSuccess([
            'userId' => $userInfo['admin_user_id'], // 管理员用户ID
            'token' => $model->getToken()          // 登录令牌（JWT）
        ], '登录成功');
    }

    /**
     * 退出登录
     * 清除当前管理员用户的登录状态
     * @return Json
     */
    public function logout(): Json
    {
        // 调用服务层退出登录方法（清除token等操作）
        AdminUserService::logout();
        return $this->renderSuccess('操作成功');
    }
}
